4.1 新增本地用户角色
基本信息
Path: /api/v2/localUserRole/create
Method: POST
接口描述:
1、需要关联"适用对象"->"组织架构"时,使用 groupNameList
可能导致关联到多个同名组织架构,后续将不再维护此参数,建议使用 groupFullPathList
作为替代
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 必须 |
Body
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
name | string | 必须 | 角色名 | ||
description | string | 非必须 | 描述 | ||
userIdList | string[] | 非必须 | 适用对象-用户ID列表 | 通过用户查询接口可以获取ID,与 userNameList只传一个即可,都传时以userIdList为主 | |
userNameList | string[] | 非必须 | 适用对象-用户名列表 | >=2.2.16开始支持, 与 userIdList只传一个即可,都传时以userIdList为主 | |
resourceIdList | string[] | 非必须 | 应用ID列表 | 通过应用查询接口可以获取ID | |
resourceNameList | string[] | 非必须 | 应用名列表 | >=2.2.16开始支持, resourceIdList和resourceNameList只传一个即可,都传时以resourceIdList为准 | |
resourceGroupIdList | string[] | 非必须 | 应用分类ID列表 | 通过应用分类查询接口可以获取ID | |
resourceGroupNameList | string[] | 非必须 | 应用分类名列表 | >=2.2.16开始支持, resourceGroupIdList和resourceGroupNameList只传一个即可,同时传时以resourceGroupIdList为准 | |
groupIdList | string[] | 非必须 | 适用对象-组织架构ID列表 | 与groupNameList、groupFullPathList只传一个即可,传多个参数时优先级为:groupIdList > groupFullPathList > groupNameList | |
groupFullPathList | string[] | 非必须 | 适用对象-组织架构全路径列表,如:["/a/b", "/a/c"] | 与groupIdList、groupNameList只传一个即可 | |
groupNameList | string[] | 非必须 | (该字段不再维护)适用对象-组织架构名列表,如:["b", "c"] | 与groupIdList、groupFullPathList只传一个即可 |
请求示例
{
"name": "userGroup",
"description": "",
"userIdList": [
"fc709cd0-9089-11eb-b814-01c566421f0e",
"baf65f80-6846-11eb-a7e5-57c537ca6be9",
"999b7740-8861-11eb-b91e-f19499d7b5ed",
"5c3294d0-580d-11eb-973d-236e909a29fd",
"591147c0-a7c6-11eb-ab50-3d5656bab316"
],
"groupIdList": [
"4c3294d0-580d-11eb-973d-236e909a29fd",
"491147c0-a7c6-11eb-ab50-3d5656bab316"
],
"resourceIdList": [],
"resourceGroupIdList": []
}
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | 错误码,非0表示失败 | ||
data | string | 必须 | 角色ID | ||
msg | string | 必须 | 描述信息 |
返回示例
{
"code": 0,
"data": "18041790-5af9-11eb-a393-bbd9cb0893d1",
"msg": "请求成功"
}
错误信息
错误提示 | 错误码 |
---|---|
组织架构格式错误,路径需以/开头,且不能存在//或以/结尾 | 7201 |
参数检查出错 | 10000001 |
角色名称(%s)已存在 | 77200005 |
本地用户组织架构不存在 | 77200001 |
本地用户不存在 | 77200001 |
部分用户数据已经删除,请重新选择 | 10000001 |
应用不存在 | 77200001 |
应用分类不存在 | 77200001 |
保存失败,关联的应用不存在或已被删除 | 77200004 |
保存失败,关联的应用分类不存在或已被删除 | 77200004 |
服务器内部错误 | 10000000 |